home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / fractals / apfelkiste / apfelkiste2.0 / doc / apfelkiste.english next >
Text File  |  1994-11-17  |  9KB  |  204 lines
  1.    *********************************************************************
  2.    *                                                                   *
  3.    *                         _________________________                 *
  4.    *                        /          ///          / \                *
  5.    *                       +-----------------------+   \               *
  6.    *                        \   |                   \   |              *
  7.    *                         \ /                  ,  \ /               *
  8.    *                          +-OOOOOOOOOOOOOOOOOO----+                *
  9.    *                         /|OOOOO§OOOOOOOOOOOOOO  /|                *
  10.    *                        / OOOOOOOOOOOOOOOOOOOOOO/ |                *
  11.    *                       +-----------------------+  |                *
  12.    *                       |          |o|          |  |                *
  13.    *                       |          |A|          |  |                *
  14.    *                       |          +-+          |  +                *
  15.    *                       |                       | /                 *
  16.    *                       |       APFELKISTE      |/                  *
  17.    *                       +-----------------------+                   *
  18.    *                                                                   *
  19.    *                                                                   *
  20.    *********************************************************************
  21.    *   Author: Michael Böhnisch,                                       *
  22.    *           Löher Str. 2,                                           *
  23.    *           4790 Paderborn (Germany)                                *
  24.    *********************************************************************
  25.    * Requirements: iff.library            Version  18.5   (or later)   *
  26.    *               color.library            -"-     1.0       -"-      *
  27.    *               Kickstart                -"-    37.175     -"-      *
  28.    * To re-build the program: Lattice/SAS C 5.10a                      *
  29.    *********************************************************************
  30.  
  31. The program is rated PD with the following restriction:
  32.     If  you change the source, please leave my name in it.  I need that
  33.     for my self-confidence.
  34.  
  35. Comments, flames, flattery via E-Mail to:
  36.  
  37.     billy@uni-paderborn.de
  38.  
  39. Please  forgive  me  for  my  awkward  english.  Feel free to correct wrong
  40. spellings or grammatical catastrophes by yourself.
  41.  
  42. *********************************************************************
  43.  
  44.                               Documentation:
  45.  
  46. "Apfelkiste"  is  yet-another-mandelbrot  program.   It's  not  as  fast as
  47. MandFXP (about 10% slower, in fact), but DAMNED fast anyway.
  48.  
  49. This version requires KS 2.0 (37.175 or higher).
  50.  
  51. The  program can be run from Workbench or Shell just as you like.  The only
  52. thing you should look for is the file "Apfel0.IFF".  This should be located
  53. in  the  active directory and is loaded at start-up to get default settings
  54. of   the   graphics.    Later  on  you  can  edit  the  configuration  file
  55. "Apfelkiste.config", where you can choose another name for the picture file
  56. and  change most of the program parameters.  The configuration file will be
  57. searched  in  the  active directory, in DEVS:  and in S:  (this order).  Do
  58. NOT  change  the  order  or general format of "Apfelkiste.config" and don't
  59. insert white spaces, or this will most likely lead to malfunctions.
  60.  
  61. A  little requester appears where you can change the borders of the area to
  62. calculate. You can set these values by mouse as described later.
  63.  
  64. Other  settings  that  can  be  manipulated  here  are the maximal depth of
  65. iteration, a border of divergence, the size of your picture in dots and the
  66. color-resolution counted in bitplanes.
  67.  
  68. The  program  chooses a "best match" of resolution and viewmodes, including
  69. EXTRA_HALFBRITE  with 64 colors in Lo-Res.  You also can calculate pictures
  70. that  are  too  big  to  display  on  a  normal  screen (e.g.  1024x1024, 2
  71. bitplanes).   These  can  be  looked at later with "Mostra" (to be found on
  72. another  AmigaLibDisk).   Since  version  28  I've  added  the "AutoScroll"
  73. feature of the new intuition library.  While "VIEWing" the picture or while
  74. drawing  with  Multitasking  "ON",  you  now  are able to scroll around the
  75. screen.
  76.  
  77. The program should work with NTSC Amigas; I have not tested this, though.
  78.  
  79. Beyond the text-gadgets you can see a panel with smaller switches:
  80.  
  81. ABOUT
  82.     Tells you who's done it and allows me to send some greetings.
  83.  
  84. FXP
  85.     Start of the generator in high speed mode.  Fasten your seatbelts!
  86.  
  87. FLOAT
  88.     Same  as  FXP, but using regular floating point routines instead of
  89.     mine.  Just to show the difference, or if you want to be VERY exact
  90.     at high degree zoom-ins.
  91.  
  92. VIEW
  93.     Make  the  request  window invisible and show the set in it's whole
  94.     beauty.   If  "Colorcycling"  is  turned  on,  there  will  be some
  95.     additional  action  on  the  screen.  [Look deep in my eyes, you're
  96.     feeling  tired  more  and more...  you feel the urge to send a '040
  97.     card  to  the author of this program...] Return to the requester by
  98.     pressing the left mouse button.
  99.  
  100. MOUSE
  101.     With  left mouse button held down you can choose a rectangular area
  102.     for magnification. (Zoom in)
  103.  
  104. QUIT
  105.     Just as it says...
  106.  
  107. LOAD
  108.     Load an IFF picture from disk.  At the moment no data referring the
  109.     Mandelbrot set are saved along with pictures.
  110.  
  111. SAVE
  112.     Save  the  newly  calculated  pictures to disk.
  113.  
  114. PRINT
  115.     Dump the picture to the printer.
  116.  
  117. DEFLT
  118.     Restore to default settings.
  119.  
  120. COLOR
  121.     A  color requester is popped up where you can change the palette of
  122.     the screen.
  123.  
  124. MULTITASKING
  125.     Switch it on or off.  Off results in a speed-up of the calculations
  126.     of  about  15%,  depending how busy your Amiga is with other tasks,
  127.     but the machine will be blocked until completion of the drawing.
  128.  
  129. COLORCYCLING
  130.     Color animation while VIEWing on or off.
  131.  
  132. ***************************************************************************
  133.  
  134. Warnings  are given as RECOVERY_ALERTS (orange rectangular at the upper end
  135. of your monitor, just like a GURU).
  136.  
  137. These  may  result  in abortion of the program, if the error was too severe
  138. too be corrected. (After freeing all used memory, of course)
  139.  
  140. In detail:
  141.  
  142. Can't open xxxxx.library Vxx.x+
  143.     One  of  the  shared libraries was not available.  Possibly you ran
  144.     out of memory, or you're not up-to-date with your LIBS:  directory.
  145.     Copy  the  missing  library  to your LIBS:  directory and try again
  146.     after rebooting.
  147.     If a library like intuition or asl is requested, you probably don't
  148.     have  Kickstart  37.175  or above and should use the 1.3 Version of
  149.     Apfelkiste.
  150.  
  151. Can't open screen
  152. Can't open window
  153.     A  screen  or  window  can  not be opened.  You may have run out of
  154.     chip-memory  or  intuition  was  not able to find enough continuous
  155.     memory.   The  program  tries  to  pop  up  the input window on the
  156.     Workbench.
  157.  
  158. No memory for filerequester
  159. Can't open printer port
  160. Can't open IORequest for printer
  161.     The  program  was  not  able  to allocate some internal structures.
  162.     These  errors  should  *NOT* occur!  Nevertheless, if they DO occur
  163.     you  really  should  switch off your computer and reboot.  There is
  164.     most likely more than one thing going wrong.
  165.  
  166. IFF file not found
  167.     The  program  tried  to open a file that was not an IFF file or did
  168.     not exist at all.  If this warning comes up just after the start of
  169.     the  program,  you  did  not  copy  the  file  "Apfel0.IFF"  to the
  170.     directory  where  you  started "Apfelkiste", or you have edited the
  171.     configuration  file  "Apfelkiste.config"  and  did  a  typo  in the
  172.     default name.
  173.  
  174. Not an IFF/ILBM file
  175.     The  program  tried  to  load  a  file  that  did  not fit into the
  176.     requirements of the standard IFF picture format (ILBM).
  177.  
  178. Scrambled IFF file
  179.     It was tried to load a picture file containing corrupted data.
  180.  
  181. Can't find configuration file
  182.     Apfelkiste  was not able to lock on the configuration file and will
  183.     use builtin default parameters.  "Apfelkiste.config" is searched in
  184.     the  current  directory,  DEVS:   and  S:   (this order).  It is an
  185.     editable  ASCII  file  and is fairly self-documenting.  Adapting it
  186.     you  should  avo